home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / shwpcx10 / showpcx.doc next >
Text File  |  1991-12-29  |  7KB  |  162 lines
  1.  
  2.  
  3.                            S H O W P C X  1.0
  4.                            ==================
  5.  
  6.                Free Software by TapirSoft Gisbert W.Selke
  7.                                 Dec 1991
  8.  
  9. ShowPCX is a simple programme that displays PCX graphics. Support for
  10. EGA, VGA, and Hercules adapters is built in; others may be used in
  11. conjunction with the appropriate BGI driver from Borland. As a bonus,
  12. support for the Tseng ET4000 chip is also built in; with this driver,
  13. you can enjoy the greater resolution this chip offers. (Cf. below for
  14. details.)
  15.  
  16. ShowPCX is not fancy; I just needed a simple PCX viewer that was command
  17. line driven and was completely royalty free -- that was the incentive
  18. behind writing this programme.
  19.  
  20. Usage is straightforward: just call ShowPCX from the DOS prompt, naming
  21. the PCX files you want to view on the command line. Example:
  22.  
  23.         showpcx  test1 test2 test3
  24.  
  25. (The file extension .PCX is assumed, unless you include a period in the
  26. file name, e.g., test1.pcc.) ShowPCX will display each image, wait for
  27. you to press a key, and then proceed to the next image, if any is left;
  28. after the last image, ShowPCX will return you to the DOS prompt. Any
  29. ordinary key (except, of course, SHIFT, CTRL, etc) will do; however,
  30. typing ESC, Q or CTRL-C will immediately return you to the DOS prompt,
  31. skipping any image that may be left. If the image is too large to fit on
  32. the screen, you will just see the top left corner -- there is no way of
  33. walking around using the cursor keys or a rodent. (Cf. the '/s' option
  34. below, though.)
  35.  
  36. Assuming that there are no other PCX files in the current directory that
  37. start with test..., you could achieve the same result as above by typing
  38.  
  39.         showpcx  test?
  40.  
  41. or
  42.  
  43.         showpcx  test*
  44.  
  45. I.e., the usual DOS wildcard characters may be used. (The order in which
  46. the files are shown may differ -- ShowPCX uses the same order as the DOS
  47. command 'dir'.) Of course, path names can be used where necessary.
  48.  
  49. A problem occurs whenever you have to name more files than will fit on
  50. the DOS command line, which is restricted by DOS to 128 characters. If
  51. you cannot make clever use of wildcards, then you can build a plain text
  52. file that contains the names of the PCX files, one or more per line.
  53. Then pass the name of this text file to ShowPCX, preceding it with the @
  54. character. Example: suppose your text file is named SLIDE.LST and
  55. contains the following lines:
  56.  
  57.         test1
  58.         test2
  59.         test3
  60.  
  61. Then calling
  62.  
  63.         showpcx  @slide.lst
  64.  
  65. will yield the same result as the examples above. (Note that there is no
  66. implied file extension in this case.) Both forms of naming files can be
  67. mixed freely, but you cannot nest file lists, that is, you can use '@'
  68. notation on the command line only.
  69.  
  70. There's one potential catch here: what do you do if your PCX file is
  71. called @TEST.PCX, e.g.? Calling 'showpcx @test' would result in ShowPCX
  72. looking for a list file called 'TEST', which is not what you'd want. The
  73. work-around in this case is to specify 'showpcx .\@test', which refers
  74. to the file '@TEST.PCX' in the current directory.
  75.  
  76. There are a few options that slightly change the behaviour of ShowPCX;
  77. they are listed below:
  78.  
  79.         /c         : centre image
  80.         /cx        : centre image horizontally only
  81.         /cy        : centre image vertically only
  82.         /d<num>    : delay in milliseconds after each image (slide show)
  83.         /e<num>    : extended VGA mode (use at your own risk!)
  84.         /h         : display help
  85.         /m         : force monochrome mode
  86.         /p         : use alternate packing strategy for scaling
  87.         /q         : quiet behaviour (don't beep)
  88.         /s[<num>]  : scale image by factor 1/<num> (0 = autoscale)
  89.         /sx[<num>] : scale horizontally only
  90.         /sy[<num>] : scale vertically only
  91.         /v         : verbose image info
  92.         /z         : zebra monochrome mode
  93.  
  94. Example: if you want to run the above example as a slide show with
  95. automatic screen changes every 10 seconds, call
  96.  
  97.         showpcx  test*  /d10000
  98.  
  99. While displaying, you can always shorten the delay by pressing any key.
  100.  
  101. We can further complicate this example by making sure that images are
  102. nicely centred and scaled (proportionally) to fit the screen:
  103.  
  104.         showpcx  test*  /d10000 /c /s
  105.  
  106. If, in addition, you have a Tseng ET4000-based SuperVGA, which supports
  107. a resolution of 1024*768 at 256 colours, you may want to call
  108.  
  109.         showpcx  test*  /d10000 /c /s /e4
  110.  
  111. The switches can be specified anywhere on the command line, but they
  112. cannot be concatenated. I.e., '/cm' is not valid, and neither is '/c/m'
  113. -- use '/c /m' instead. Note that '/c' is the same as '/cx /cy', but
  114. '/s' is, in general, not the same as '/sx /sy'! The numbers must be
  115. integer, by the way.
  116.  
  117. The result of the switches should mostly be clear from the above;
  118. otherwise, just try them out -- that's easier than to have it explained.
  119. A few hints, though: it is hard to tell beforehand whether the '/p' and
  120. '/z' switches should be used; if you use packing and/or monochrome
  121. mode, and the default behaviour is unsatisfactory, try these switches.
  122. The '/e' switch is somewhat dangerous -- if you know enough about your
  123. graphics adapter and the BGI driver you probably have supplied yourself,
  124. you can force the video mode to whatever is possible, even if ShowPCX
  125. has no built-in knowlege about it. If used improperly, this may damage
  126. your video adapter and/or screen -- caveat emptor! The built-in
  127. driver for the ET4000 supports the modes:
  128.  
  129.         /e0 :   320x200x256  Standard VGA
  130.         /e1 :   640x400x256  SuperVGA
  131.         /e2 :   640x480x256  SuperVGA
  132.         /e3 :   800x600x256  SuperVGA
  133.         /e4 :   1024x768x256 SuperVGA
  134.  
  135.  
  136. Legal stuff:
  137.  
  138. This is free software; as such, it comes without any warranties
  139. whatsoever. It works for me; I cannot be held responsible for any
  140. damage caused. You have been warned. If it doesn't work for you, make it
  141. fit for yourself -- that's why the source is included. Just give credit
  142. where credit is due. Otherwise, this software can be used and copied
  143. freely; however, it must not be sold for profit.
  144.  
  145. The name BGI is owned by Borland International; the name ET4000 is
  146. property of Tseng Labs. The format of PCX files and the name of this
  147. format were created by ZSoft. The SVGA256.BGI driver for the ET4000 chip
  148. was supplied by Jordan P. Hargrave and is highly recommended. Please
  149. consider ordering and registering his unit.
  150.  
  151. If anything goes wrong (and it sure will...), I can, for the time being,
  152. be contacted at one of these addresses:
  153.  
  154. TapirSoft                             <s00100@dbnrhrz1.bitnet>
  155. Gisbert W.Selke                       <s00100@ibm.rhrz1.uni-bonn.de>
  156. Ermekeilstraße 28                     <gisbert@watsun.cc.columbia.edu>
  157. D-5300 Bonn 1
  158. Germany
  159.  
  160. Enjoy!
  161.  
  162.